Node / meshtastic / Meshtastic-Android / commits / 0e79532

Parents : a54824c

Author : James Rich <james.a.rich@gmail.com>

Date : 2026-05-18T10:02:22-05:00

docs: update spec status to Implemented and reflect architecture

- Status: Not Started → Implemented

- FR-008: Updated to reflect hardcoded sample node (not Room query)

- Component table: NodeItem/NodeItemCompact now in core:ui

- Assumptions: Updated live preview description

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

1 files changed, 5 insertions(+), 5 deletions(-)

M specs/20260507-161758-node-list-layout/spec.md +5 -5

--- a/specs/20260507-161758-node-list-layout/spec.md

+++ b/specs/20260507-161758-node-list-layout/spec.md

**Feature Branch**: `002-node-list-layout`

**Created**: 2026-05-07

**Input**: Node layout engine with complete and compact views for Compose Multiplatform

## Summary

|-----------|---------------|---------|

| `NodeListDensity` | `feature/node/model/` | Enum: `COMPLETE` / `COMPACT` |

| `NodeListLayoutPreferences` | `core/prefs/ui/` | DataStore keys for density + 9 compact toggles |

| `NodeLayoutSettings` | `feature/settings/` | Density picker (SegmentedButton) + compact toggles + live preview |

| `NodeListScreen` | `feature/node/list/` | Parent composable — reads density, delegates to correct item |

| `NodeListHelp` | `feature/node/component/` | Help bottom sheet with signal legend + quality indicator docs |

- **FR-005**: All toggles MUST default to `true` (enabled) except "Relative Last Heard Time" which defaults to `false`.

- **FR-006**: The "Relative Last Heard Time" toggle MUST be disabled (grayed out via `enabled = false`) when "Last Heard Time" is toggled off.

- **FR-007**: When "Complete" is selected, the toggle section MUST be replaced with descriptive text: "The Complete layout displays all available node data. Fields with no data are automatically hidden."

- **FR-009**: The compact layout MUST render as a two-column `Row`: Column 1 (fixed width: `NodeChip` + battery), Column 2 (`Modifier.weight(1f)`: `Column` of up to 3 content rows).

- **FR-010**: The short name MUST always render as a `NodeChip` composable in compact mode, maintaining consistent card styling at all sizes.

- **FR-011**: The chip height MUST scale adaptively: `max(36.dp, min(70.dp, 24.dp × lineCount))` where `lineCount` counts active row groups (1 base + 1 if last-heard enabled + 1 if any combined-row toggle is enabled). The chip MUST use `Modifier.defaultMinSize()` rather than hard `Modifier.size()` to allow growth when system font scaling exceeds 100%.

- The node list data model (`Node` in `core:model`, backed by `NodeEntity` in `core:database`) is fully populated by the packet processing pipeline. The layout engine only reads — it never writes to the model.

- `NodeChip`, `MaterialBatteryInfo`, `HopsInfo`, `DistanceInfo`, `LoraSignalIndicator`, and `LastHeardInfo` are pre-existing reusable components in `core:ui`. The layout engine composes them but does not modify them.

- `determineSignalQuality(snr, rssi)` uses absolute SNR/RSSI thresholds (not modem-preset-relative). The `Quality` enum (`GOOD`, `FAIR`, `BAD`, `NONE`) drives icon color for both layouts.

- The Complete layout is intentionally not configurable — its purpose is to show everything, acting as the baseline reference.

- All business logic and UI composables reside in `commonMain` source set. No platform-specific code is required for this feature.

- String resources for toggle labels and help text are added to `core/resources/src/commonMain/composeResources/values/strings.xml` using `stringResource(Res.string.key)`.